home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 21 / Mac Magazin and MacEasy Magazine CD - Issue 21.iso / Wissenschaft & Technik / yorick_docs folder / yorick_docs / graph.doc < prev    next >
Text File  |  1996-02-28  |  58KB  |  1,211 lines
  1.  
  2.  
  3.  
  4.                           Yorick Documentation
  5.                 for functions, variables, and structures
  6.                          defined in file graph.i
  7.                    Printed: Fri Feb  9 08:29:31 1996
  8.  
  9.    Contents:
  10.  
  11.               animate                                 msize
  12.               arrowl                                  mspace
  13.               arroww                                  opaque
  14.               aspect                                  palette
  15.               bytscl                                  path
  16.               closed                                  pause
  17.               color                                   plc
  18.               current_window                          pldefault
  19.               ecolor                                  pldj
  20.               edges                                   pledit
  21.               eps                                     plf
  22.               ewidth                                  plfp
  23.               fma                                     plg
  24.               font                                    pli
  25.               gridxy                                  plm
  26.               hcp                                     plmesh
  27.               hcp_file                                plq
  28.               hcp_finish                              plsys
  29.               hcp_out                                 plt
  30.               hcpoff                                  pltitle
  31.               hcpon                                   plv
  32.               height                                  range
  33.               hide                                    rays
  34.               histeq_scale                            redraw
  35.               hollow                                  region
  36.               justify                                 rphase
  37.               legend                                  rspace
  38.               limits                                  smooth
  39.               logxy                                   triangle
  40.               marker                                  type
  41.               marks                                   unzoom
  42.               mcolor                                  width
  43.               mesh_loc                                window
  44.               mouse                                   winkill
  45.               moush                                   zoom_factor
  46.               mphase
  47.  
  48.                                                      FROM animate TO closed
  49.  
  50.                                                                     animate
  51. /* DOCUMENT animate
  52.          or animate, 0/1
  53.      without any arguments, toggles animation mode; with argument 0,
  54.      turns off animation mode, with argument 1 turns on animation mode.
  55.      In animation mode, the X window associated with a graphics window
  56.      is actually an offscreen pixmap which is bit-blitted onscreen
  57.      when an fma command is issued.  This is confusing unless you are
  58.      actually trying to make a movie, but results in smoother animation
  59.      if you are.  Generally, you should turn animation on, run your movie,
  60.      then turn it off.
  61.    SEE ALSO: window, fma, plg
  62.  */
  63.  
  64.                                                                      arrowl
  65.     /* SEE rspace     */
  66.  
  67.                                                                      arroww
  68.     /* SEE rspace     */
  69.  
  70.                                                                      aspect
  71.     /* SEE hollow     */
  72.  
  73.                                                                      bytscl
  74. /* DOCUMENT bytscl(z)
  75.          or bytscl(z, top=max_byte, cmin=lower_cutoff, cmax=upper_cutoff)
  76.      returns a char array of the same shape as Z, with values linearly
  77.      scaled to the range 0 to one less than the current palette size.
  78.      If MAX_BYTE is specified, the scaled values will run from 0 to
  79.      MAX_BYTE instead.
  80.      If LOWER_CUTOFF and/or UPPER_CUTOFF are specified, Z values outside
  81.      this range are mapped to the cutoff value; otherwise the linear
  82.      scaling maps the extreme values of Z to 0 and MAX_BYTE.
  83.    SEE ALSO: plf, pli, histeq_scale
  84.  */
  85.  
  86.                                                                      closed
  87. /* DOCUMENT closed=   plotting keyword
  88.          or smooth=   plotting keyword
  89.      selects closed curves (closed=1) or default open curves (closed=0),
  90.      or Bezier smoothing (smooth>0) or default piecewise linear curves
  91.      (smooth=0).  The value of smooth can be 1, 2, 3, or 4 to get
  92.      successively more smoothing.  Only the Bezier control points are
  93.      plotted to an X window; the actual Bezier curves will show up in
  94.      PostScript hardcopy files.  Closed curves join correctly, which
  95.      becomes more noticeable for wide lines; non-solid closed curves
  96.      may look bad because the dashing pattern may be incommensurate
  97.      with the length of the curve.
  98.    PLOTTING COMMANDS: plg, plc (smooth only)
  99.    SEE ALSO: type, width, color, marks, marker, rays
  100.  */
  101.  
  102.                                                        FROM color TO ewidth
  103.  
  104.                                                                       color
  105. /* DOCUMENT color=   plotting keyword
  106.      selects line or text color.  Valid values are the strings "bg", "fg",
  107.      "black", "white", "red", "green", "blue", "cyan", "magenta", "yellow",
  108.      or a 0-origin index into the current palette.  The default is "fg".
  109.      Negative numbers may be used instead of the strings: -1 is bg
  110.      (background), -2 is fg (foreground), -3 is black, -4 is white,
  111.      -5 is red, -6 is green, -7 is blue, -8 is cyan, -9 is magenta, and
  112.      -10 is yellow.
  113.    PLOTTING COMMANDS: plg, plm, plc, pldj, plt
  114.    SEE ALSO: type, width, marks, marker, mcolor, rays, closed, smooth
  115.  */
  116.  
  117.                                                              current_window
  118. /* DOCUMENT n= current_window()
  119.      returns the number of the current graphics window, or -1 if none.
  120.  */
  121.  
  122.                                                                      ecolor
  123.     /* SEE edges     */
  124.  
  125.                                                                       edges
  126. /* DOCUMENT edges=   plotting keyword
  127.          or ecolor=   plotting keyword
  128.          or ewidth=   plotting keyword
  129.      set the appearance of the zone edges in a filled mesh plot (plf).
  130.      By default, edges=0, and the zone edges are not plotted.  If
  131.      edges=1, a solid line is drawn around each zone after it is
  132.      filled; the edge color and width are given by ecolor and ewidth,
  133.      which are "fg" and 1.0 by default.
  134.    PLOTTING COMMANDS: plf
  135.    SEE ALSO: color, width
  136.  */
  137.  
  138.                                                                         eps
  139. /* DOCUMENT eps, name
  140.      writes the picture in the current graphics window to the Encapsulated
  141.      PostScript file NAME+".epsi" (i.e.- the suffix .epsi is added to NAME).
  142.      The eps function requires the ps2epsi utility which comes with the
  143.      project GNU Ghostscript program.  Any hardcopy file associated with
  144.      the current window is first closed, but the default hardcopy file is
  145.      unaffected.  As a side effect, legends are turned off and color table
  146.      dumping is turned on for the current window.
  147.      The external variable PS2EPSI_FORMAT contains the format for the
  148.      command to start the ps2epsi program.
  149.    SEE ALSO: window, fma, hcp, hcp_finish, plg
  150.  */
  151.  
  152.                                                                      ewidth
  153.     /* SEE edges     */
  154.  
  155.                                                            FROM fma TO font
  156.  
  157.                                                                         fma
  158. /* DOCUMENT fma
  159.      frame advance the current graphics window.  The current picture
  160.      remains displayed in the associated X window until the next element
  161.      is actually plotted.
  162.    SEE ALSO: window, hcp, animate, plg
  163.  */
  164.  
  165.                                                                        font
  166. /* DOCUMENT font=     plotting keyword
  167.          or height=   plotting keyword
  168.          or opaque=   plotting keyword
  169.          or path=     plotting keyword
  170.          or justify=  plotting keyword
  171.      selects text properties.  The font can be any of the strings
  172.      "courier", "times", "helvetica" (the default), "symbol", or
  173.      "schoolbook".  Append "B" for boldface and "I" for italic, so
  174.      "courierB" is boldface Courier, "timesI" is Times italic, and
  175.      "helveticaBI" is bold italic (oblique) Helvetica.  Your X server
  176.      should have the Adobe fonts (available free from the MIT X
  177.      distribution tapes) for all these fonts, preferably at both 75
  178.      and 100 dpi.  Occasionally, a PostScript printer will not be
  179.      equipped for some fonts; often New Century Schoolbook is missing.
  180.      The font keyword may also be an integer: 0 is Courier, 4 is Times,
  181.      8 is Helvetica, 12 is Symbol, 16 is New Century Schoolbook, and
  182.      you add 1 to get boldface and/or 2 to get italic (or oblique).
  183.  
  184.      The height is the font size in points; 14.0 is the default.
  185.      X windows only has 8, 10, 12, 14, 18, and 24 point fonts, so
  186.      don't stray from these sizes if you want what you see on the
  187.      screen to be a reasonably close match to what will be printed.
  188.  
  189.      By default, opaque=0 and text is transparent.  Set opaque=1 to
  190.      white-out a box before drawing the text.  The default path
  191.      (path=0) is left-to-right text; set path=1 for top-to-bottom text.
  192.  
  193.      The default text justification, justify="NN" is normal is both
  194.      the horizontal and vertical directions.  Other possibilities
  195.      are "L", "C", or "R" for the first character, meaning left,
  196.      center, and right horizontal justification, and "T", "C", "H",
  197.      "A", or "B", meaning top, capline, half, baseline, and bottom
  198.      vertical justification.  The normal justification "NN" is equivalent
  199.      to "LA" if path=0, and to "CT" if path=1.  Common values are
  200.      "LA", "CA", and "RA" for garden variety left, center, and right
  201.      justified text, with the y coordinate at the baseline of the
  202.      last line in the string presented to plt.  The characters labeling
  203.      the right axis of a plot are "RH", so that the y value of the
  204.      text will match the y value of the corresponding tick.  Similarly,
  205.      the characters labeling the bottom axis of a plot are "CT".
  206.      The justification may also be a number, horizontal+vertical,
  207.      where horizontal is 0 for "N", 1 for "L", 2 for "C", or 3 for "R",
  208.      and vertical is 0 for "N", 4 for "T", 8 for "C", 12 for "H",
  209.  
  210.                                                            FROM font TO hcp
  211.  
  212.      16 for "A", or 20 for "B".
  213.  
  214.    PLOTTING COMMANDS: plt
  215.    SEE ALSO: color
  216.  */
  217.  
  218.                                                                      gridxy
  219. /* DOCUMENT gridxy, flag
  220.          or gridxy, xflag, yflag
  221.      Turns on or off grid lines according to FLAG.  In the first form, both
  222.      the x and y axes are affected.  In the second form, XFLAG and YFLAG
  223.      may differ to have different grid options for the two axes.  In either
  224.      case, a FLAG value of 0 means no grid lines (the default), a value of
  225.      1 means grid lines at all major ticks (the level of ticks which get
  226.      grid lines can be set in the style sheet), and a FLAG value of 2 means
  227.      that the coordinate origin only will get a grid line.  In styles with
  228.      multiple coordinate systems, only the current coordinate system is
  229.      affected.
  230.      The keywords can be used to affect the style of the grid lines.
  231.  
  232.      You can also turn the ticks off entirely.  (You might want to do this
  233.      to plot your own custom set of tick marks when the automatic tick
  234.      generating machinery will never give the ticks you want.  For example
  235.      a latitude axis in degrees might reasonably be labeled "0, 30, 60,
  236.      90", but the automatic machinery considers 3 an "ugly" number - only
  237.      1, 2, and 5 are "pretty" - and cannot make the required scale.  In
  238.      this case, you can turn off the automatic ticks and labels, and use
  239.      plsys, pldj, and plt to generate your own.)
  240.      To fiddle with the tick flags in this general manner, set the
  241.      0x200 bit of FLAG (or XFLAG or YFLAG), and "or-in" the 0x1ff bits
  242.      however you wish.  The meaning of the various flags is described
  243.      in the file Y_SITE/gist/work.gs.  Additionally, you can use the
  244.      0x400 bit to turn on or off the frame drawn around the viewport.
  245.      Here are some examples:
  246.         gridxy,0x233        work.gs default setting
  247.         gridxy,,0x200       like work.gs, but no y-axis ticks or labels
  248.         gridxy,,0x231       like work.gs, but no y-axis ticks on right
  249.         gridxy,0x62b        boxed.gs default setting
  250.  
  251.    KEYWORDS: color, type, width
  252.    SEE ALSO: window, plsys, limits, range, logxy
  253.  */
  254.  
  255.                                                                         hcp
  256. /* DOCUMENT hcp
  257.             hcpon
  258.         hcpoff
  259.      The hcp command sends the picture displayed in the current graphics
  260.      window to the hardcopy file.  (The name of the default hardcopy file
  261.      can be specified using hcp_file; each individual graphics window may
  262.      have its own hardcopy file as specified by the window command.)
  263.  
  264.                                                          FROM hcp TO height
  265.  
  266.      The hcpon command causes every fma (frame advance) command to do
  267.      and implicit hcp, so that every frame is sent to the hardcopy file.
  268.      The hcpoff command reverts to the default "demand only" mode.
  269.    SEE ALSO: window, fma, plg
  270.  */
  271.  
  272.                                                                    hcp_file
  273. /* DOCUMENT hcp_file, filename, dump=0/1
  274.      sets the default hardcopy file to FILENAME.  If FILENAME ends with
  275.      ".ps", the file will be a PostScript file, otherwise it will be a
  276.      binary CGM file.  By default, the hardcopy file name will be
  277.      "Aa00.cgm", or "Ab00.cgm" if that exists, or "Ac00.cgm" if both
  278.      exist, and so on.  The default hardcopy file gets hardcopy from all
  279.      graphics windows which do not have their own specific hardcopy file
  280.      (see the window command).  If the dump keyword is present and non-zero,
  281.      the current palette will be dumped at the beginning of each frame
  282.      of the default hardcopy file.  With dump=0, the default behavior of
  283.      converting all colors to a gray scale is restored.
  284.    SEE ALSO: window, fma, hcp, plg
  285.  */
  286.  
  287.                                                                  hcp_finish
  288. /* DOCUMENT filename= hcp_finish()
  289.          or filename= hcp_finish(n)
  290.      closes the current hardcopy file and returns the filename.
  291.      If N is specified, closes the hcp file associated with window N
  292.      and returns its name; use hcp_finish(-1) to close the default
  293.      hardcopy file.
  294.    SEE ALSO: window, fma, hcp, hcp_out, plg
  295.  */
  296.  
  297.                                                                     hcp_out
  298. /* DOCUMENT hcp_out
  299.          or hcp_out, n
  300.      finishes the current hardcopy file and sends it to the printer.
  301.      If N is specified, prints the hcp file associated with window N;
  302.      use hcp_out,-1 to print the default hardcopy file.
  303.      Unless the KEEP keyword is supplied and non-zero, the file will
  304.      be deleted after it is processed by gist and sent to lpr.
  305.    SEE ALSO: window, fma, hcp, hcp_finish, plg
  306.  */
  307.  
  308.                                                                      hcpoff
  309.     /* SEE hcp     */
  310.  
  311.                                                                       hcpon
  312.     /* SEE hcp     */
  313.  
  314.                                                                      height
  315.     /* SEE font     */
  316.  
  317.                                                         FROM hide TO legend
  318.  
  319.                                                                        hide
  320. /* DOCUMENT hide=   plotting keyword
  321.      sets the visibility of a plotted element.  The default is hide=0,
  322.      which means that the element will be visible.  Use hide=1 to remove
  323.      the element from the plot (but not from the display list).
  324.    PLOTTING COMMANDS: plg, plm, plc, plv, plf, pli, plt, pldj
  325.    SEE ALSO: legend
  326.  */
  327.  
  328.                                                                histeq_scale
  329. /* DOCUMENT histeq_scale(z, top=top_value, cmin=cmin, cmax=cmax)
  330.      returns a byte-scaled version of the array Z having the property
  331.      that each byte occurs with equal frequency (Z is histogram
  332.      equalized).  The result bytes range from 0 to TOP_VALUE, which
  333.      defaults to one less than the size of the current palette (or
  334.      255 if no pli, plf, or palette command has yet been issued).
  335.  
  336.      If non-nil CMIN and/or CMAX is supplied, values of Z beyond these
  337.      cutoffs are not included in the frequency counts.
  338.  
  339.    SEE ALSO: bytscl, plf, pli
  340.  */
  341.  
  342.                                                                      hollow
  343. /* DOCUMENT hollow=   plotting keyword
  344.          or aspect=   plotting keyword
  345.      set the appearance of the "darts" of a vector field plot.  The
  346.      default darts, hollow=0, are filled; use hollow=1 to get just the
  347.      dart outlines.  The default is aspect=0.125; aspect is the ratio
  348.      of the half-width to the length of the darts.  Use the color
  349.      keyword to control the color of the darts.
  350.    PLOTTING COMMANDS: plv
  351.    SEE ALSO: color
  352.  */
  353.  
  354.                                                                     justify
  355.     /* SEE font     */
  356.  
  357.                                                                      legend
  358. /* DOCUMENT legend=   plotting keyword
  359.      sets the legend for a plot.  The default legend is a concatentation
  360.      of the strings used in the original plotting command (plg, plm, etc.),
  361.      except for the plt command, which has no default legend.
  362.      Legends are never plotted to the X window; use the plq command to
  363.      see them interactively.  Legends will appear in hardcopy output
  364.      unless they have been explicitly turned off.
  365.    PLOTTING COMMANDS: plg, plm, plc, plv, plf, pli, plt, pldj
  366.    SEE ALSO: hide
  367.  */
  368.  
  369.                                                       FROM limits TO limits
  370.  
  371.                                                                      limits
  372. /* DOCUMENT limits
  373.          or limits, xmin, xmax, ymin, ymax,
  374.                 square=0/1, nice=0/1, restrict=0/1
  375.      or old_limits= limits()
  376.      or limits, old_limits
  377.  
  378.      In the first form, restores all four plot limits to extreme values.
  379.  
  380.      In the second form, sets the plot limits in the current coordinate
  381.      system to XMIN, XMAX, YMIN, YMAX, which may be nil or omitted to
  382.      leave the corresponding limit unchanged, a number to fix the
  383.      corresponding limit to a specified value, or the string "e" to
  384.      make the corresponding limit take on the extreme value of the
  385.      currently displayed data.
  386.  
  387.      If present, the square keyword determines whether limits marked
  388.      as extreme values will be adjusted to force the x and y scales
  389.      to be equal (square=1) or not (square=0, the default).
  390.      If present, the nice keyword determines whether limits will be
  391.      adjusted to nice values (nice=1) or not (nice=0, the default).
  392.      There is a subtlety in the meaning of "extreme value" when one
  393.      or both of the limits on the OPPOSITE axis have fixed values --
  394.      does the "extreme value" of the data include points which
  395.      will not be plotted because their other coordinate lies outside
  396.      the fixed limit on the opposite axis (restrict=0, the default),
  397.      or not (restrict=1)?
  398.  
  399.      If called as a function, limits returns an array of 5 doubles;
  400.      OLD_LIMITS(1:4) are the current xmin, xmax, ymin, and ymax,
  401.      and int(OLD_LIMITS(5)) is a set of flags indicating extreme
  402.      values and the square, nice, restrict, and log flags.
  403.  
  404.      In the fourth form, OLD_LIMITS is as returned by a previous
  405.      limits call, to restore the limits to a previous state.
  406.  
  407.      In an X window, the limits may also be adjusted interactively
  408.      with the mouse.  Drag left to zoom in and pan (click left to zoom
  409.      in on a point without moving it), drag middle to pan, and click
  410.      (and drag) right to zoom out (and pan).  If you click just above
  411.      or below the plot, these operations will be restricted to the
  412.      x-axis; if you click just to the left or right, the operations
  413.      are restricted to the y-axis.  A shift-left click, drag, and
  414.      release will expand the box you dragged over to fill the plot
  415.      (other popular software zooms with this paradigm).  If the
  416.      rubber band box is not visible with shift-left zooming, try
  417.      shift-middle or shift-right for alternate XOR masks.  Such
  418.      mouse-set limits are equivalent to a limits command specifying
  419.      all four limits EXCEPT that the unzoom command can revert to
  420.      the limits before a series of mouse zooms and pans.
  421.  
  422.      The limits you set using the limits or range functions carry over
  423.  
  424.                                                     FROM limits TO mesh_loc
  425.  
  426.      to the next plot -- that is, an fma operation does NOT reset the
  427.      limits to extreme values.
  428.  
  429.    SEE ALSO: plsys, range, logxy, zoom_factor, unzoom, plg
  430.  */
  431.  
  432.                                                                       logxy
  433. /* DOCUMENT logxy, xflag, yflag
  434.      sets the linear/log axis scaling flags for the current coordinate
  435.      system.  XFLAG and YFLAG may be nil or omitted to leave the
  436.      corresponding axis scaling unchanged, 0 to select linear scaling,
  437.      or 1 to select log scaling.
  438.    SEE ALSO: plsys, limits, range, plg, gridxy
  439.  */
  440.  
  441.                                                                      marker
  442. /* DOCUMENT marker=   plotting keyword
  443.      selects the character used for occasional markers along a polyline,
  444.      or for the polymarker if type is "none".  The special values
  445.      '\1', '\2', '\3', '\4', and '\5' stand for point, plus, asterisk,
  446.      circle, and cross, which are prettier than text characters on output
  447.      to some devices.  The default marker is the next available capital
  448.      letter, 'A', 'B', ..., 'Z'.
  449.    PLOTTING COMMANDS: plg, plc
  450.    SEE ALSO: type, width, color, marks, rays, mspace, mphase, msize, mcolor
  451.  */
  452.  
  453.                                                                       marks
  454. /* DOCUMENT marks=   plotting keyword
  455.      selects unadorned lines (marks=0), or lines with occasional markers
  456.      (marks=1).  Ignored if type is "none" (indicating polymarkers instead
  457.      of occasional markers).  The spacing and phase of the occasional
  458.      markers can be altered using the mspace and mphase keywords; the
  459.      character used to make the mark can be altered using the marker
  460.      keyword.
  461.    PLOTTING COMMANDS: plg, plc
  462.    SEE ALSO: type, width, color, marker, rays, mspace, mphase, msize, mcolor
  463.  */
  464.  
  465.                                                                      mcolor
  466.     /* SEE mspace     */
  467.  
  468.                                                                    mesh_loc
  469. /* DOCUMENT mesh_loc(y0, x0)
  470.          or mesh_loc(y0, x0, y, x)
  471.          or mesh_loc(y0, x0, y, x, ireg)
  472.      returns the zone index (=i+imax*(j-1)) of the zone of the mesh
  473.      (X,Y) (with optional region number array IREG) containing the
  474.      point (X0,Y0).  If (X0,Y0) lies outside the mesh, returns 0.
  475.      Thus, eg- ireg(mesh_loc(x0, y0, y, x, ireg)) is the region number of
  476.      the region containing (x0,y0).  If no mesh specified, uses default.
  477.      X0 and Y0 may be arrays as long as they are conformable.
  478.    SEE ALSO: plmesh, moush, mouse
  479.  */
  480.  
  481.                                                        FROM mouse TO mphase
  482.  
  483.                                                                       mouse
  484. /* DOCUMENT result= mouse(system, style, prompt)
  485.      displays a PROMPT, then waits for a mouse button to be pressed,
  486.      then released.  Returns array of eleven doubles:
  487.        result= [x_pressed, y_pressed, x_released, y_released,
  488.                 xndc_pressed, yndc_pressed, xndc_released, yndc_released,
  489.             system, button, modifiers]
  490.  
  491.      If SYSTEM>=0, the first four coordinate values will be relative to
  492.      that coordinate system.
  493.      For SYSTEM<0, the first four coordinate values will be relative to
  494.      the coordinate system under the mouse when the button was pressed.
  495.      The second four coordinates are always normalized device coordinates,
  496.      which start at (0,0) in the lower left corner of the 8.5x11 sheet of
  497.      paper the picture will be printed on, with 0.0013 NDC unit being
  498.      1/72.27 inch (1.0 point).  Look in the style sheet for the location
  499.      of the viewport in NDC coordinates (see the style keyword).
  500.  
  501.      If STYLE is 0, there will be no visual cues that the mouse
  502.      command has been called; this is intended for a simple click.
  503.      If STYLE is 1, a rubber band box will be drawn; if STYLE is 2,
  504.      a rubber band line will be drawn.  These disappear when the
  505.      button is released.
  506.  
  507.      Clicking a second button before releasing the first cancels the
  508.      mouse function, which will then return nil.
  509.      Ordinary text input also cancels the mouse function, which again
  510.      returns nil.
  511.  
  512.      The left button reverses forground for background (by XOR) in
  513.      order to draw the rubber band (if any).  The middle and right
  514.      buttons use other masks, in case the rubber band is not visible
  515.      with the left button.
  516.  
  517.      long(result(9)) is the coordinate system in which the first four
  518.      coordinates are to be interpreted.
  519.      long(result(10)) is the button which was pressed, 1 for left, 2
  520.      for middle, and 3 for right (4 and 5 are also possible).
  521.      long(result(11)) is a mask representing the modifier keys which
  522.      were pressed during the operation: 1 for shift, 2 for shift lock,
  523.      4 for control, 8 for mod1 (alt or meta), 16 for mod2, 32 for mod3,
  524.      64 for mod4, and 128 for mod5.
  525.  
  526.    SEE ALSO: moush
  527.  */
  528.  
  529.                                                                       moush
  530. /* DOCUMENT moush()
  531.          or moush(y, x, ireg)
  532.      returns the 1-origin zone index for the point clicked in
  533.      for the default mesh, or for the mesh (X,Y) (region array IREG).
  534.  */
  535.  
  536.                                                                      mphase
  537.     /* SEE mspace     */
  538.  
  539.                                                       FROM msize TO palette
  540.  
  541.                                                                       msize
  542.     /* SEE mspace     */
  543.  
  544.                                                                      mspace
  545. /* DOCUMENT mspace=   plotting keyword
  546.          or mphase=   plotting keyword
  547.          or msize=    plotting keyword
  548.          or mcolor=   plotting keyword
  549.      selects the spacing, phase, and size of occasional markers placed
  550.      along polylines.  The msize also selects polymarker size if type
  551.      is "none".  The spacing and phase are in NDC units (0.0013 NDC
  552.      equals 1.0 point); the default mspace is 0.16, and the default
  553.      mphase is 0.14, but mphase is automatically incremented for
  554.      successive curves on a single plot.  The msize is in relative
  555.      units, with the default msize of 1.0 representing 10 points.
  556.      The mcolor keyword is the same as the color keyword, but controls
  557.      the marker color instead of the line color.  Setting the color
  558.      automatically sets the mcolor to the same value, so you only
  559.      need to use mcolor if you want the markers for a curve to be a
  560.      different color than the curve itself.
  561.    PLOTTING COMMANDS: plg, plc
  562.    SEE ALSO: type, width, color, marks, marker, rays
  563.  */
  564.  
  565.                                                                      opaque
  566.     /* SEE font     */
  567.  
  568.                                                                     palette
  569. /* DOCUMENT palette, filename
  570.          or palette, source_window_number
  571.          or palette, red, green, blue, ntsc=1/0
  572.          or palette, red, green, blue, gray
  573.      or palette, red, green, blue, query=1
  574.      or palette, red, green, blue, gray, query=1
  575.      sets (or retrieves with query=1) the palette for the current
  576.      graphics window.  The FILENAME is the name of a Gist palette file;
  577.      the standard palettes are "earth.gp", "stern.gp", "rainbow.gp",
  578.      "heat.gp", "gray.gp", and "yarg.gp".  Use the maxcolors keyword
  579.      in the pldefault command to put an upper limit on the number of
  580.      colors which will be read from the palette in FILENAME.
  581.  
  582.      In the second form, the palette for the current window is copied
  583.      from the SOURCE_WINDOW_NUMBER.  If the X colormap for the window is
  584.      private, there will still be two separate X colormaps for the two
  585.      windows, but they will have the same color values.
  586.  
  587.      In the third form, RED, GREEN, and BLUE are 1-D arrays of the same
  588.      length specifying the palette you wish to install; the values
  589.      should vary between 0 and 255, and your palette should have no
  590.      more than 240 colors.  If ntsc=0, monochrome devices (such as most
  591.      laser printers) will use the average brightness to translate your
  592.      colors into gray; otherwise, the NTSC (television) averaging will
  593.      be used (.30*RED+.59*GREEN+.11*BLUE).  Alternatively, you can specify
  594.      GRAY explicitly.
  595.  
  596.  
  597.                                                   FROM palette TO pldefault
  598.  
  599.      Ordinarily, the palette is not dumped to a hardcopy file
  600.      (color hardcopy is still rare and expensive), but you can
  601.      force the palette to dump using the window or hcp_file commands.
  602.  
  603.      See the dump= keyword for the hcp_file and window commands if you
  604.      are having trouble getting color in your hardcopy files.
  605.  
  606.    SEE ALSO: window, fma, hcp, pldefault, plg
  607.  */
  608.  
  609.                                                                        path
  610.     /* SEE font     */
  611.  
  612.                                                                       pause
  613. /* DOCUMENT pause, milliseconds
  614.      pause for the specified number of milliseconds of wall clock
  615.      time, or until input arrives from the keyboard.
  616.      This is intended for use in creating animated sequences.
  617.  */
  618.  
  619.                                                                         plc
  620. /* DOCUMENT plc, z, y, x, levs=z_values
  621.          or plc, z, y, x, ireg, levs=z_values
  622.      or plc, z, levs=z_values
  623.      plots a contours of Z on the mesh Y versus X.  Y, X, and IREG are
  624.      as for plm.  The Z array must have the same shape as Y and X.
  625.      The function being contoured takes the value Z at each point
  626.      (X,Y) -- that is, the Z array is presumed to be point-centered.
  627.      The Y, X, and IREG arguments may all be omitted to default to the
  628.      mesh set by the most recent plmesh call.
  629.      The LEVS keyword is a list of the values of Z at which you want
  630.      contour curves.  The default is eight contours spanning the
  631.      range of Z.
  632.      The following keywords are legal (each has a separate help entry):
  633.    KEYWORDS: legend, hide
  634.          type, width, color, smooth
  635.              marks, marker, mspace, mphase
  636.          smooth, triangle, region
  637.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp, plmesh
  638.              limits, logxy, range, fma, hcp
  639.  */
  640.  
  641.                                                                   pldefault
  642. /* DOCUMENT pldefault, key1=value1, key2=value2, ...
  643.      sets default values for the various properties of graphical elements.
  644.  
  645.      The keywords can be most of the keywords that can be passed to the
  646.      plotting commands:
  647.        plg:  color, type, width,
  648.              marks, mcolor, msize, mspace, mphase,
  649.          rays, rspace, rphase, arrowl, arroww
  650.        pldj: color, type, width
  651.        plt:  color, font, height, path, justify, opaque
  652.        plm:  color, type, width
  653.        plv:  color, hollow, width, aspect
  654.  
  655.                                                    FROM pldefault TO pledit
  656.  
  657.        plc:  color, type, width,
  658.              marks, mcolor, marker, msize, mspace, mphase
  659.        plf:  edges, ecolor, ewidth
  660.  
  661.      The initial default values are:
  662.        color="fg", type="solid", width=1.0 (1/2 point),
  663.        marks=1, mcolor="fg", msize=1.0 (10 points),
  664.           mspace=0.16, mphase=0.14,
  665.        rays=0, arrowl=1.0 (10 points), arroww=1.0 (4 points),
  666.           rspace=0.13, rphase=0.11375,
  667.        font="helvetica", height=12.0, path=0, justify="NN", opaque=0,
  668.        hollow= 0, aspect=0.125,
  669.        edges=0, ecolor="fg", ewidth=1.0 (1/2 point)
  670.  
  671.      Additional default keywords are:
  672.        dpi, style, legends  (see window command)
  673.        palette              (to set default filename as in palette command)
  674.        maxcolors            (default 200)
  675.  
  676.    SEE ALSO: window, plsys, plq, pledit, plg
  677.  */
  678.  
  679.                                                                        pldj
  680. /* DOCUMENT pldj, x0, y0, x1, y1
  681.      plots disjoint lines from (X0,Y0) to (X1,Y1).  X0, Y0, X1, and Y1
  682.      may have any dimensionality, but all must have the same number of
  683.      elements.
  684.      The following keywords are legal (each has a separate help entry):
  685.    KEYWORDS: legend, hide
  686.          type, width, color
  687.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp
  688.              limits, logxy, range, fma, hcp
  689.  */
  690.  
  691.                                                                      pledit
  692. /* DOCUMENT pledit, key1=value1, key2=value2, ...
  693.          or pledit, n_element, key1=value1, key2=value2, ...
  694.          or pledit, n_element, n_contour, key1=value1, key2=value2, ...
  695.      changes some property of element number N_ELEMENT (and contour
  696.      number N_CONTOUR of that element).  If N_ELEMENT and N_CONTOUR are
  697.      omitted, the default is the most recently added element, or the
  698.      element specified in the most recent plq query command.
  699.  
  700.      The keywords can be any of the keywords that apply to the current
  701.      element.  These are:
  702.        plg:  color, type, width,
  703.              marks, mcolor, marker, msize, mspace, mphase,
  704.          rays, rspace, rphase, arrowl, arroww,
  705.          closed, smooth
  706.        pldj: color, type, width
  707.        plt:  color, font, height, path, justify, opaque
  708.        plm:  region, boundary, inhibit, color, type, width
  709.        plf:  region
  710.        plv:  region, color, hollow, width, aspect, scale
  711.        plc:  region, color, type, width,
  712.  
  713.                                                         FROM pledit TO plfp
  714.  
  715.              marks, mcolor, marker, msize, mspace, mphase
  716.          smooth, levs
  717.      (For contours, if you aren't talking about a particular N_CONTOUR,
  718.       any changes will affect ALL the contours.)
  719.  
  720.      A plv (vector field) element can also take the scalem
  721.      keyword to multiply all vector lengths by a specified factor.
  722.  
  723.      A plt (text) element can also take the dx and/or dy
  724.      keywords to adjust the text position by (dx,dy).
  725.  
  726.    SEE ALSO: window, plsys, plq, pldefault, plg
  727.  */
  728.  
  729.                                                                         plf
  730. /* DOCUMENT plf, z, y, x
  731.          or plf, z, y, x, ireg
  732.      or plf, z
  733.      plots a filled mesh Y versus X.  Y, X, and IREG are as for plm.
  734.      The Z array must have the same shape as Y and X, or one smaller
  735.      in both dimensions.  If Z is of type char, it is used "as is",
  736.      otherwise it is linearly scaled to fill the current palette, as
  737.      with the bytscl function.
  738.      (See the bytscl function for explanation of top, cmin, cmax.)
  739.      The mesh is drawn with each zone in the color derived from the Z
  740.      function and the current palette; thus Z is interpreted as a
  741.      zone-centered array.
  742.      The Y, X, and IREG arguments may all be omitted to default to the
  743.      mesh set by the most recent plmesh call.
  744.      A solid edge can optionally be drawn around each zone by setting
  745.      the EDGES keyword non-zero.  ECOLOR and EWIDTH determine the edge
  746.      color and width.  The mesh is drawn zone by zone in order from
  747.      IREG(2+imax) to IREG(jmax*imax) (the latter is IREG(imax,jmax)),
  748.      so you can achieve 3D effects by arranging for this order to
  749.      coincide with back-to-front order.  If Z is nil, the mesh zones
  750.      are filled with the background color, which you can use to
  751.      produce 3D wire frames.
  752.      The following keywords are legal (each has a separate help entry):
  753.    KEYWORDS: legend, hide
  754.          region, top, cmin, cmax, edges, ecolor, ewidth
  755.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp, plmesh,
  756.              limits, logxy, range, fma, hcp, palette, bytscl, histeq_scale
  757.  */
  758.  
  759.                                                                        plfp
  760. /* DOCUMENT plfp, z, y, x, n
  761.      plots a list of filled polygons Y versus X, with colors Z.
  762.      The N array is a 1D list of lengths (number of corners) of the
  763.      polygons; the 1D colors array Z has the same length as N.  The
  764.      X and Y arrays have length sum(N).
  765.      The Z array must have the same shape as Y and X.  If Z is of
  766.      type char, it is used "as is", otherwise it is linearly scaled
  767.      to fill the current palette, as with the bytscl function.
  768.      (See the bytscl function for explanation of top, cmin, cmax.)
  769.  
  770.                                                            FROM plfp TO plm
  771.  
  772.      The following keywords are legal (each has a separate help entry):
  773.    KEYWORDS: legend, hide, top, cmin, cmax
  774.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj
  775.              limits, logxy, range, fma, hcp
  776.  */
  777.  
  778.                                                                         plg
  779. /* DOCUMENT plg, y, x
  780.          or plg, y
  781.      plots a graph of Y versus X.  Y and X must be 1-D arrays of equal
  782.      length; if X is omitted, it defaults to [1, 2, ..., numberof(Y)].
  783.      The following keywords are legal (each has a separate help entry):
  784.    KEYWORDS: legend, hide
  785.          type, width, color, closed, smooth
  786.              marks, marker, mspace, mphase
  787.          rays, arrowl, arroww, rspace, rphase
  788.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp
  789.              limits, logxy, range, fma, hcp
  790.  */
  791.  
  792.                                                                         pli
  793. /* DOCUMENT pli, z
  794.          or pli, z, x1, y1
  795.          or pli, z, x0, y0, x1, y1
  796.      plots the image Z as a cell array -- an array of equal rectangular
  797.      cells colored according to the 2-D array Z.  The first dimension
  798.      of Z is plotted along x, the second dimension is along y.
  799.      If Z is of type char, it is used "as is", otherwise it is linearly
  800.      scaled to fill the current palette, as with the bytscl function.
  801.      (See the bytscl function for explanation of top, cmin, cmax.)
  802.      If X1 and Y1 are given, they represent the coordinates of the
  803.      upper right corner of the image.  If X0, and Y0 are given, they
  804.      represent the coordinates of the lower left corner, which is at
  805.      (0,0) by default.  If only the Z array is given, each cell will be
  806.      a 1x1 unit square, with the lower left corner of the image at (0,0).
  807.      The following keywords are legal (each has a separate help entry):
  808.    KEYWORDS: legend, hide, top, cmin, cmax
  809.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp,
  810.              limits, logxy, range, fma, hcp, palette, bytscl, histeq_scale
  811.  */
  812.  
  813.                                                                         plm
  814. /* DOCUMENT plm, y, x, boundary=0/1, inhibit=0/1/2
  815.          or plm, y, x, ireg, boundary=0/1, inhibit=0/1/2
  816.      or plm, boundary=0/1, inhibit=0/1/2
  817.      plots a mesh of Y versus X.  Y and X must be 2-D arrays with equal
  818.      dimensions.  If present, IREG must be a 2-D region number array
  819.      for the mesh, with the same dimensions as X and Y.  The values of
  820.      IREG should be positive region numbers, and zero for zones which do
  821.      not exist.  The first row and column of IREG never correspond to any
  822.      zone, and should always be zero.  The default IREG is 1 everywhere
  823.      else.  If present, the BOUNDARY keyword determines whether the
  824.      entire mesh is to be plotted (boundary=0, the default), or just the
  825.      boundary of the selected region (boundary=1).  If present, the
  826.      INHIBIT keyword causes the (X(,j),Y(,j)) lines to not be plotted
  827.  
  828.                                                             FROM plm TO plq
  829.  
  830.      (inhibit=1), or the (X(i,),Y(i,)) lines to not be plotted (inhibit=2).
  831.      By default (inhibit=0), mesh lines in both logical directions are
  832.      plotted.
  833.      The Y, X, and IREG arguments may all be omitted to default to the
  834.      mesh set by the most recent plmesh call.
  835.      The following keywords are legal (each has a separate help entry):
  836.    KEYWORDS: legend, hide
  837.          type, width, color
  838.          region
  839.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp, plmesh
  840.              limits, logxy, range, fma, hcp
  841.  */
  842.  
  843.                                                                      plmesh
  844. /* DOCUMENT plmesh, y, x, ireg, triangle=tri_array
  845.          or plmesh
  846.      sets the default mesh for subsequent plm, plc, plv, and plf calls.
  847.      In the second form, deletes the default mesh (until you do this,
  848.      or switch to a new default mesh, the default mesh arrays persist and
  849.      take up space in memory).  The Y, X, and IREG arrays should all be
  850.      the same shape; Y and X will be converted to double, and IREG will
  851.      be converted to int.  If IREG is omitted, it defaults to IREG(1,)=
  852.      IREG(,1)= 0, IREG(2:,2:)=1; that is, region number 1 is the whole
  853.      mesh.  The triangulation array TRI_ARRAY is used by plc; the
  854.      correspondence between TRI_ARRAY indices and zone indices is the
  855.      same as for IREG, and its default value is all zero.
  856.      The IREG or TRI_ARRAY arguments may be supplied without Y and X
  857.      to change the region numbering or triangulation for a given set of
  858.      mesh coordinates.  However, a default Y and X must already have been
  859.      defined if you do this.
  860.      If Y is supplied, X must be supplied, and vice-versa.
  861.    SEE ALSO: plm, plc, plv, plf, plfp
  862.  */
  863.  
  864.                                                                         plq
  865. /* DOCUMENT plq
  866.          or plq, n_element
  867.      or plq, n_element, n_contour
  868.      or legend_list= plq()
  869.      or properties= plq(n_element, n_contour)
  870.      Called as a subroutine, prints the list of legends for the current
  871.      coordinate system (with an "(H)" to mark hidden elements), or prints
  872.      a list of current properties of element N_ELEMENT (such as line type,
  873.      width, font, etc.), or of contour number N_CONTOUR of element number
  874.      N_ELEMENT (which must be contours generated using the plc command).
  875.      Called as a function, returns either the list of legend strings, or a
  876.      list of pointers to the values of the various element properties.
  877.      Elements and contours are both numbered starting with one; hidden
  878.      elements or contours are included in this numbering.
  879.  
  880.      The PROPERTIES list returned by plq is a list of pointers to the
  881.      relevent properties for the specified graphical element.  Each
  882.      possible property has a particular index in the returned PROPERTIES
  883.      list as follows:
  884.      *PROPERTIES(1)   int([element type (0 for none, 1 for plg, 2 for pldj,
  885.  
  886.                                                           FROM plq TO plsys
  887.  
  888.                                          3 for plt, 4 for plm, 5 for plf,
  889.                      6 for plv, 7 for plc, 8 for pli,
  890.                      9 for plfp),
  891.                            hide flag])
  892.      *PROPERTIES(2)   string(legend)
  893.      *PROPERTIES(3)   int array, depends on type (names match keywords):
  894.        1 plg:  [color, type, marks, mcolor, marker, rays, closed, smooth]
  895.        2 pldj: [color, type]
  896.        3 plt:  [color, font, path, justify, opaque]
  897.        4 plm:  [color, type, region, boundary, inhibit]
  898.        5 plf:  [region, edges, ecolor]
  899.        6 plv:  [region, color, hollow]
  900.        7 plc:  [region, color, type, marks, mcolor, marker, smooth]
  901.        8 pli:  nil
  902.      *PROPERTIES(4)   double array, depends on type (names match keywords):
  903.        1 plg:  [width, msize, mspace, mphase, rspace, rphase, arrowl, arroww]
  904.        2 pldj: [width]
  905.        3 plt:  [height, x, y]
  906.        4 plm:  [width]
  907.        5 plf:  [ewidth]
  908.        6 plv:  [width, aspect, scale]
  909.        7 plc:  [width, msize, mspace, mphase]
  910.        8 pli:  [x0, x1, y0, y1]
  911.      *PROPERTIES(5)   long array, depends on type (names match arguments):
  912.        1 plg:  [npoints, &x, &y]
  913.        2 pldj: [npoints, &x0, &y0, &x1, &y1]
  914.        3 plt:  [nchars, &text]
  915.        4 plm:  [imax, jmax, &x, &y, &ireg]
  916.        5 plf:  [imax, jmax, &x, &y, &ireg, &colors]
  917.        6 plv:  [imax, jmax, &x, &y, &ireg, &vx, &vy]
  918.        7 plc:  [imax, jmax, &x, &y, &ireg, &z, &triangle, nlevs, &levs]
  919.        8 pli:  [imax, jmax, &colors]
  920.        9 plfp: [n, &x, &y, &colors, &pn]
  921.      You can use the reshape function to peek at the data at the addresses
  922.      returned in PROPERTIES(5) as longs.  The appropriate data types are:
  923.      char for text, int for ireg, short for triangle, char for colors, and
  924.      double for everything else.  In a plf, colors is (imax-1)-by-(jmax-1).
  925.      Although PROPERTIES(5) returns pointers to the data plotted, attempting
  926.      to poke new values into this data will not produce immediate changes
  927.      to your plot, since the graphics package does not realize that anything
  928.      has changed.  Use pledit to make changes to plotted elements.
  929.  
  930.      The plq function always operates on the current coordinate system
  931.      in the current graphics window; use window and plsys to change these.
  932.    SEE ALSO: window, plsys, pledit, pldefault, plg
  933.  */
  934.  
  935.                                                                       plsys
  936. /* DOCUMENT plsys, n
  937.      sets the current coordinate system to number N in the current
  938.      graphics window.  If N equals 0, subsequent elements will be
  939.      plotted in absolute NDC coordinates outside of any coordinate
  940.      system.  The default style sheet "work.gs" defines only a single
  941.      coordinate system, so the only other choice is N equal 1.  You
  942.      can make up your own style sheet (using a text editor) which
  943.  
  944.                                                           FROM plsys TO plv
  945.  
  946.      defines mulitple coordinate systems.  You need to do this if
  947.      you want to display four plots side by side on a single page,
  948.      for example.  The standard style sheets "work2.gs" and "boxed2.gs"
  949.      define two overlayed coordinate systems with the first labeled
  950.      to the right of the plot and the second labeled to the left of
  951.      the plot.  When using overlayed coordinate systems, it is your
  952.      responsibility to ensure that the x-axis limits in the two
  953.      systems are identical.
  954.    SEE ALSO: window, limits, plg
  955.  */
  956.  
  957.                                                                         plt
  958. /* DOCUMENT plt, text, x, y, tosys=0/1
  959.      plots TEXT (a string) at the point (X,Y).  The exact relationship
  960.      between the point (X,Y) and the TEXT is determined by the
  961.      justify keyword.  TEXT may contain newline ("\n") characters
  962.      to output multiple lines of text with a single call.  The
  963.      coordinates (X,Y) are NDC coordinates (outside of any coordinate
  964.      system) unless the tosys keyword is present and non-zero, in
  965.      which case the TEXT will be placed in the current coordinate
  966.      system.  However, the character height is NEVER affected by the
  967.      scale of the coordinate system to which the text belongs.
  968.      Note that the pledit command takes dx and/or dy keywords to
  969.      adjust the position of existing text elements.
  970.      The following keywords are legal (each has a separate help entry):
  971.    KEYWORDS: legend, hide
  972.          color, font, height, opaque, path, justify
  973.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp, pledit
  974.              limits, range, fma, hcp, pltitle
  975.  */
  976.  
  977.                                                                     pltitle
  978. /* DOCUMENT pltitle, title
  979.      Plot TITLE centered above the coordinate system for any of the
  980.      standard Gist styles.  You will need to customize this for other
  981.      plot styles.
  982.  */
  983.  
  984.                                                                         plv
  985. /* DOCUMENT plv, vy, vx, y, x, scale=dt
  986.          or plv, vy, vx, y, x, ireg, scale=dt
  987.      or plv, vy, vx, scale=dt
  988.      plots a vector field (VX,VY) on the mesh (X,Y).  Y, X, and IREG are
  989.      as for plm.  The VY and VX arrays must have the same shape as Y and X.
  990.      The Y, X, and IREG arguments may all be omitted to default to the
  991.      mesh set by the most recent plmesh call.
  992.      The SCALE keyword is the conversion factor from the units of
  993.      (VX,VY) to the units of (X,Y) -- a time interval if (VX,VY) is a velocity
  994.      and (X,Y) is a position -- which determines the length of the
  995.      vector "darts" plotted at the (X,Y) points.  If omitted, SCALE is
  996.      chosen so that the longest ray arrows have a length comparable
  997.      to a "typical" zone size.
  998.      You can use the scalem keyword in pledit to make adjustments to the
  999.      SCALE factor computed by default.
  1000.      The following keywords are legal (each has a separate help entry):
  1001.  
  1002.                                                          FROM plv TO rphase
  1003.  
  1004.    KEYWORDS: legend, hide
  1005.          type, width, color, smooth
  1006.              marks, marker, mspace, mphase
  1007.          triangle, region
  1008.    SEE ALSO: plg, plm, plc, plv, plf, pli, plt, pldj, plfp, plmesh, pledit,
  1009.              limits, logxy, range, fma, hcp
  1010.  */
  1011.  
  1012.                                                                       range
  1013. /* DOCUMENT range, ymin, ymax
  1014.      sets the y-axis plot limits in the current coordinate system to
  1015.      YMIN, YMAX, which may be nil or omitted to leave the corresponding
  1016.      limit unchanged, a number to fix the corresponding limit to a
  1017.      specified value, or the string "e" to make the corresponding limit
  1018.      take on the extreme value of the currently displayed data.
  1019.      Use    limits, xmin, xmin
  1020.      to accomplish the same function for the x-axis plot limits.
  1021.    SEE ALSO: plsys, limits, logxy, plg
  1022.  */
  1023.  
  1024.                                                                        rays
  1025. /* DOCUMENT rays=   plotting keyword
  1026.      selects unadorned lines (rays=0), or lines with occasional ray
  1027.      arrows (rays=1).  Ignored if type is "none".  The spacing and phase
  1028.      of the occasional arrows can be altered using the rspace and rphase
  1029.      keywords; the shape of the arrowhead can be modified using the
  1030.      arroww and arrowl keywords.
  1031.    PLOTTING COMMANDS: plg, plc
  1032.    SEE ALSO: type, width, color, marker, marks, rspace, rphase
  1033.              arroww, arrowl
  1034.  */
  1035.  
  1036.                                                                      redraw
  1037. /* DOCUMENT redraw
  1038.      redraws the X window associated with the current graphics window.
  1039.    SEE ALSO: window, fma, hcp, plg
  1040.  */
  1041.  
  1042.                                                                      region
  1043. /* DOCUMENT region=   plotting keyword
  1044.      selects the part of mesh to consider.  The region should match one
  1045.      of the numbers in the IREG array.  Putting region=0 (the default)
  1046.      means to plot the entire mesh, that is, everything EXCEPT region
  1047.      zero (non-existent zones).  Any other number means to plot only
  1048.      the specified region number; region=3 would plot region 3 only.
  1049.    PLOTTING COMMANDS: plm, plc, plv, plf
  1050.  */
  1051.  
  1052.                                                                      rphase
  1053.     /* SEE rspace     */
  1054.  
  1055.                                                         FROM rspace TO type
  1056.  
  1057.                                                                      rspace
  1058. /* DOCUMENT rspace=   plotting keyword
  1059.          or rphase=   plotting keyword
  1060.          or arroww=   plotting keyword
  1061.          or arrowl=   plotting keyword
  1062.      selects the spacing, phase, and size of occasional ray arrows
  1063.      placed along polylines.  The spacing and phase are in NDC units
  1064.      (0.0013 NDC equals 1.0 point); the default rspace is 0.13, and
  1065.      the default rphase is 0.11375, but rphase is automatically
  1066.      incremented for successive curves on a single plot.
  1067.      The arrowhead width, arroww, and arrowhead length, arrowl are
  1068.      in relative units, defaulting to 1.0, which translates to an
  1069.      arrowhead 10 points long and 4 points in half-width.
  1070.    PLOTTING COMMANDS: plg
  1071.    SEE ALSO: type, width, color, marks, marker, rays
  1072.  */
  1073.  
  1074.                                                                      smooth
  1075.     /* SEE closed     */
  1076.  
  1077.                                                                    triangle
  1078. /* DOCUMENT triangle=   plotting keyword
  1079.      sets the triangulation array for a contour plot.  The triangulation
  1080.      array must be the same shape as the IREG (region number) array, and
  1081.      the correspondence between mesh zones and indices is the same as
  1082.      for IREG.  The triangulation array is used to resolve the ambiguity
  1083.      in saddle zones, in which the function Z being contoured has two
  1084.      diagonally opposite corners high, and the other two corners low.
  1085.      The triangulation array element for a zone is 0 if the algorithm is
  1086.      to choose a triangulation, based on the curvature of the first
  1087.      contour to enter the zone.  If zone (i,j) is to be triangulated
  1088.      from point (i-1,j-1) to point (i,j), then TRIANGLE(i,j)=1,
  1089.      while if it is to be triangulated from (i-1,j) to (i,j-1), then
  1090.      TRIANGLE(i,j)=-1.  Contours will never cross this "triangulation
  1091.      line".
  1092.      You should rarely need to fiddle with the traingulation array;
  1093.      it is a hedge for dealing with pathological cases.
  1094.    PLOTTING COMMANDS: plc
  1095.  */
  1096.  
  1097.                                                                        type
  1098. /* DOCUMENT type=   plotting keyword
  1099.      selects line type.  Valid values are the strings "solid", "dash",
  1100.      "dot", "dashdot", "dashdotdot", and "none".  The "none" value
  1101.      causes the line to be plotted as a polymarker.
  1102.      The type value may also be a number; 0 is "none", 1 is "solid",
  1103.      2 is "dash", 3 is "dot", 4 is "dashdot", and 5 is "dashdotdot".
  1104.    PLOTTING COMMANDS: plg, plm, plc, pldj
  1105.    SEE ALSO: width, color, marks, marker, rays, closed, smooth
  1106.  */
  1107.  
  1108.                                                       FROM unzoom TO window
  1109.  
  1110.                                                                      unzoom
  1111. /* DOCUMENT unzoom
  1112.      restores limits to their values before zoom and pan operations
  1113.      performed interactively using the mouse.
  1114.      Use    old_limits=  limits()
  1115.             ...
  1116.         limits, old_limits
  1117.      to save and restore plot limits generally.
  1118.    SEE ALSO: limits, range, zoom_factor, plg
  1119.  */
  1120.  
  1121.                                                                       width
  1122. /* DOCUMENT width=   plotting keyword
  1123.      selects line width.  Valid values are positive floating point numbers
  1124.      giving the line thickness relative to the default line width of one
  1125.      half point, width= 1.0.
  1126.    PLOTTING COMMANDS: plg, plm, plc, pldj, plv (only if hollow=1)
  1127.    SEE ALSO: type, color, marks, marker, rays, closed, smooth
  1128.  */
  1129.  
  1130.                                                                      window
  1131. /* DOCUMENT window, n, display="host:server.screen", dpi=100/75, wait=0/1,
  1132.                        private=0/1, hcp="hcp_filename", dump=0/1,
  1133.                        legends=1/0, style="style_sheet_filename"
  1134.      select window N as the current graphics output window.  N may
  1135.      range from 0 to 7, inclusive.  Each graphics window corresponds to
  1136.      an X window, and optionally has its own associated hardcopy file.
  1137.      If N is omitted, it defaults to the current coordinate system.
  1138.  
  1139.      The X window will appear on your default display at 75 dpi, unless
  1140.      you specify the display and/or dpi keywords.  A dpi=100 X window
  1141.      is larger than a dpi=75 X window; both represent the same thing
  1142.      on paper.  Use display="" to create a graphics window which has
  1143.      no associated X window (you should do this if you want to make
  1144.      plots in a non-interactive batch mode).
  1145.  
  1146.      By default, an X window will attempt to use shared colors, which
  1147.      permits several Yorick graphics windows (including windows from
  1148.      multiple instances of Yorick) to use a common palette.  You can
  1149.      force an X window to post its own colormap (set its colormap
  1150.      attribute) with the private=1 keyword.  You will most likely have
  1151.      to fiddle with your window manager to understand how it handles
  1152.      colormap focus if you do this.  Use private=0 to return to shared
  1153.      colors.
  1154.  
  1155.      By default, Yorick will not wait for the X window to become visible;
  1156.      code which creates a new window, then plots a series of frames to
  1157.      that window should use wait=1 to assure that all frames are actually
  1158.      plotted.
  1159.  
  1160.      By default, a graphics window does NOT have a hardcopy file
  1161.      of its own -- any request for hardcopy are directed to the
  1162.      default hardcopy file, so hardcopy output from any window goes
  1163.      to a single file.  By specifying the hcp keyword, however, a
  1164.      hardcopy file unique to this window will be created.  If the
  1165.  
  1166.                                                  FROM window TO zoom_factor
  1167.  
  1168.      "hcp_filename" ends in ".ps", the hardcopy file will be a PostScript
  1169.      file; otherwise, hardcopy files are in binary CGM format.  Use
  1170.      hcp="" to revert to the default hardcopy file (closing the window
  1171.      specific file, if any).  The legends keyword, if present, controls
  1172.      whether the curve legends are (legends=1, the default) or are not
  1173.      (legends=0) dumped to the hardcopy file.  The dump keyword, if
  1174.      present, controls whether all colors are converted to a gray scale
  1175.      (dump=0, the default), or the current palette is dumped at the
  1176.      beginning of each page of hardcopy output.  (The legends keyword
  1177.      applies to all pictures dumped to hardcopy from this graphics
  1178.      window.  The dump keyword applies only to the specific hardcopy
  1179.      file defined using the hcp keyword -- use the dump keyword in the
  1180.      hcp_file command to get the same effect in the default hardcopy
  1181.      file.)
  1182.  
  1183.      If both display="" and hcp="", the graphics window will be
  1184.      entirely eliminated.
  1185.  
  1186.      The style keyword, if present, specifies the name of a Gist style
  1187.      sheet file; the default is "work.gs".  The style sheet determines
  1188.      the number and location of coordinate systems, tick and label styles,
  1189.      and the like.  Other choices include "axes.gs", "boxed.gs",
  1190.      "work2.gs", and "boxed2.gs".
  1191.  
  1192.      If invoked as a function, window(...) returns the current
  1193.      window number.
  1194.    SEE ALSO: plsys, hcp_file, fma, hcp, redraw, palette, animate, plg,
  1195.              winkill, gridxy
  1196.  */
  1197.  
  1198.                                                                     winkill
  1199. /* DOCUMENT winkill
  1200.          or winkill, n
  1201.      deletes the current graphics window, or graphics window N (0-7).
  1202.    SEE ALSO: window
  1203.  */
  1204.  
  1205.                                                                 zoom_factor
  1206. /* DOCUMENT zoom_factor, factor
  1207.      sets the zoom factor for mouse-click zoom in and zoom out operations.
  1208.      The default FACTOR is 1.5; FACTOR should always be greater than 1.0.
  1209.    SEE ALSO: limits, range, unzoom, plg
  1210.  */
  1211.